<HTML
><HEAD
><TITLE
>GR_IMAGE_HDR</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Nano-X Library API"
HREF="index.html"><LINK
REL="UP"
TITLE="Nano-X Data Types"
HREF="nxstruct.html"><LINK
REL="PREVIOUS"
TITLE="GR_IMAGE_INFO"
HREF="nxstruct_GR_IMAGE_INFO.html"><LINK
REL="NEXT"
TITLE="GR_KEY"
HREF="nxstruct_GR_KEY.html"></HEAD
><BODY
CLASS="REFENTRY"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Nano-X Library API</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="nxstruct_GR_IMAGE_INFO.html"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="nxstruct_GR_KEY.html"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="NXSTRUCT.GR.IMAGE.HDR"
><SPAN
CLASS="TYPE"
>GR_IMAGE_HDR</SPAN
></A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN10556"
></A
><H2
>Name</H2
><SPAN
CLASS="TYPE"
>GR_IMAGE_HDR</SPAN
>&nbsp;--&nbsp;Image header</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN10560"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct 
{
    int            width;
    int            height;
    int            planes;
    int            bpp;
    int            pitch;
    int            bytesperpixel;
    int            compression;
    int            palsize;
    GR_COLOR       transcolor;
    GR_PALENTRY   *palette;
    unsigned char *imagebits;
} GR_IMAGE_HDR;
  </PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10562"
></A
><H2
>Description</H2
><P
>    A <SPAN
CLASS="STRUCTNAME"
>GR_IMAGE_HDR</SPAN
> structure defines a nano-X
    image. This structure is the image header. It in turn points to a
    palette array and a bitmap array that combined contain the image data.
    </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>    You use this structure with the <A
HREF="nxapi_GrDrawImageBits.html"
>    <TT
CLASS="FUNCTION"
>GrDrawImageBits()</TT
></A
> function.
    The utility application <SPAN
CLASS="APPLICATION"
>convbmp</SPAN
> that
    comes with Microwindows will build
    <SPAN
CLASS="STRUCTNAME"
>GR_IMAGE_HDR</SPAN
> structures that may be
    compiled into your application.
    </P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10572"
></A
><H2
>Fields</H2
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10574"
></A
><P
></P
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><THEAD
><TR
><TH
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>Type</TH
><TH
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>Name</TH
><TH
WIDTH="50%"
ALIGN="LEFT"
VALIGN="TOP"
>Description</TH
></TR
></THEAD
><TBODY
><TR
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="TYPE"
>int</SPAN
></TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>width</TD
><TD
WIDTH="50%"
ALIGN="LEFT"
VALIGN="TOP"
>The width of the image in pixels.</TD
></TR
><TR
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="TYPE"
>int</SPAN
></TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>height</TD
><TD
WIDTH="50%"
ALIGN="LEFT"
VALIGN="TOP"
>The height of the image in pixels.</TD
></TR
><TR
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="TYPE"
>int</SPAN
></TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>planes</TD
><TD
WIDTH="50%"
ALIGN="LEFT"
VALIGN="TOP"
>The number of color planes in the image.</TD
></TR
><TR
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="TYPE"
>int</SPAN
></TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>bpp</TD
><TD
WIDTH="50%"
ALIGN="LEFT"
VALIGN="TOP"
>The number if bits per pixel in the image.</TD
></TR
><TR
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="TYPE"
>int</SPAN
></TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>pitch</TD
><TD
WIDTH="50%"
ALIGN="LEFT"
VALIGN="TOP"
>The number of bytes per line in the image.</TD
></TR
><TR
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="TYPE"
>int</SPAN
></TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>bytesperpixel</TD
><TD
WIDTH="50%"
ALIGN="LEFT"
VALIGN="TOP"
>The number of bytes per pixel in the image.</TD
></TR
><TR
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="TYPE"
>int</SPAN
></TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>compression</TD
><TD
WIDTH="50%"
ALIGN="LEFT"
VALIGN="TOP"
>The compression algorithm used in the image.</TD
></TR
><TR
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="TYPE"
>int</SPAN
></TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>palsize</TD
><TD
WIDTH="50%"
ALIGN="LEFT"
VALIGN="TOP"
>The number pallete entries used by the image.</TD
></TR
><TR
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
><A
HREF="nxstruct_GR_COLOR.html"
>        <SPAN
CLASS="TYPE"
>GR_COLOR</SPAN
></A
></TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>transcolor</TD
><TD
WIDTH="50%"
ALIGN="LEFT"
VALIGN="TOP"
>This field defines a color that if contained in the
        image will appear transparent. When the image is drawn any
        pixels that are of this color are not drawn, thus letting the
        existing screen iage through. Set this field to -1 if no
        transparent color is desired.</TD
></TR
><TR
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
><A
HREF="nxstruct_GR_PALNTRY.html"
>        <SPAN
CLASS="TYPE"
>GR_PALENTRY*</SPAN
></A
></TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>palette</TD
><TD
WIDTH="50%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to the image's color palette.</TD
></TR
><TR
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="TYPE"
>unsigned char*</SPAN
></TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>imagebits</TD
><TD
WIDTH="50%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a bitmap array containing the image data.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10642"
></A
><H2
>See Also</H2
><P
>      <A
HREF="nxapi_GrDrawImageBits.html"
>            <TT
CLASS="FUNCTION"
>GrDrawImageBits()</TT
></A
>, 
      <A
HREF="nxstruct_GR_IMAGE_INFO.html"
>            <SPAN
CLASS="STRUCTNAME"
>GR_IMAGE_INFO</SPAN
></A
>.
    </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="nxstruct_GR_IMAGE_INFO.html"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="nxstruct_GR_KEY.html"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><SPAN
CLASS="TYPE"
>GR_IMAGE_INFO</SPAN
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="nxstruct.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>GR_KEY</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>